home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Games / PC-SIG World of Games (CDRM1080710) (1993).iso / ENT / DISK3238.ZIP / ARJSHELL.DOC < prev    next >
Text File  |  1992-09-09  |  17KB  |  343 lines
  1.  
  2.  
  3.             ARJSHELL v1.50 is Copyright (c)1992 by A Kellett
  4.  
  5.         ARJ is Copyright (c) 1990-1992 by Robert K. Jung.  This program,
  6.         ARJShell, is in no way associated with Robert K. Jung, it is
  7.         merely my attempt to make his excellent compression product even
  8.         easier to use.  Thanks for trying ARJShell, I hope you find it
  9.         useful.
  10.  
  11.         To print out this manual, at the DOS prompt type:
  12.            TYPE ARJSHELL.DOC > PRN
  13.  
  14.  
  15.       ***************************** DISCLAIMER ******************************
  16.       ARJSHELL IS LICENSED  "AS-IS".  A. KELLETT  MAKES NO WARRANTIES, EITHER
  17.       EXPRESSED  OR  IMPLIED, WITH  RESPECT  TO THIS  SOFTWARE, ITS  QUALITY,
  18.       PERFORMANCE,  MERCHANTABILITY,  OR FITNESS FOR  ANY PARTICULAR PURPOSE.
  19.       IN PARTICULAR, IT IS NOT GUARANTEED TO PREVENT OR DETECT DAMAGE TO YOUR
  20.       DATA OR  PROGRAMS.  IN  NO  EVENT  SHALL A. KELLETT  BE  LIABLE FOR ANY
  21.       CLAIMS FOR LOST PROFITS OR  ANY  DAMAGE, INCLUDING, BUT NOT LIMITED TO,
  22.       SPECIAL,  INCIDENTAL,  CONSEQUENTIAL  OR OTHER  DAMAGE.  SOME STATES DO
  23.       NOT ALLOW THE  EXCLUSION OR  LIMITATION OF  INCIDENTAL OR CONSEQUENTIAL
  24.       DAMAGES, SO THE ABOVE  LIMITATION OR  EXCLUSION  MAY  NOT APPLY TO YOU.
  25.       IN  NO CASE SHALL A. KELLETTs'  LIABILITY  EXCEED THE LICENSE FEES PAID
  26.       FOR THE RIGHT TO USE THE  LICENSED SOFTWARE.  THE LICENSE AGREEMENT AND
  27.       WARRANTY SHALL BE  CONSTRUED, INTERPRETED  AND  GOVERNED BY THE LAWS OF
  28.       THE STATE OF GEORGIA.
  29.       ***************************** DISCLAIMER ******************************
  30.  
  31.  
  32.                            ARJShell FEATURES:
  33.  
  34.         *   Easy-to-use interface: except for filenames, the Return/Enter
  35.             key and the cursor keys will get you anywhere.
  36.  
  37.         *   No switches to memorize: almost anything ARJ can do for you,
  38.             ARJShell will handle.
  39.  
  40.         *   Superior compression: ARJ v2.30 will compress smaller than
  41.             PKZIP v1.1 on most types of files.
  42.  
  43.         *   ARJShell is small: less than 25k of valuable disk space,
  44.             perfect for floppy-only or laptop users.
  45.  
  46.         *   Fast operation: ARJ is fast and so is ARJShell, even runs
  47.             quickly on older 4.77MHz PCs.
  48.  
  49.         *   Security: compress your sensitive files into a space saving
  50.             ARJ archive and garble them with your own password.
  51.  
  52.         *   Convenience: archive files into a tightly compressed
  53.             self-extracting EXE to freely distribute via modem or disks.
  54.  
  55.         *   Save time: move your files to and from archived format
  56.             without typing any DOS commands.
  57.  
  58.         *   Save space: compressed files leave you more valuable disk
  59.             real estate (a precious commodity).
  60.  
  61.         *   Many options: compress to the max or go for the speed,
  62.             you can find a balance suited to your needs.
  63.  
  64.         *   Beats paper training a litter of puppies!  Ooops, how did
  65.             that get in here??
  66.  
  67.         *   Low cost/high value: Registration is very affordable and
  68.             you can try out ALL the features before you buy!
  69.  
  70.  
  71.                            WHY USE ARJShell?
  72.         I have been a long and die-hard fan of PKZIP, but the much
  73.         better compression ratios of ARJ finally won me over.  I now
  74.         have over 500k of available hard drive room at home since moving
  75.         4MB of ZIP files over to ARJ format.  ARJ also has more switches
  76.         than anybody would usually want.  The complexity of all these
  77.         switches was one thing that prompted me to start working on the
  78.         early versions of ARJSHELL (yes, necessity IS the mother of
  79.         invention).  All YOU have to remember is the path/filenames of
  80.         the files you want to work with.  You can even easily try
  81.         different compression methods to see what advantages or
  82.         disadvantages they have using your own files!  You can compress
  83.         to self-extracting EXE's, garble with a password, move files to
  84.         and from archives, and much more!  If you use ARJ or simply want
  85.         more valuable disk space available, try the ARJ and ARJShell
  86.         team today!!  [End Of Commercial]
  87.  
  88.  
  89.                              REGISTRATION:
  90.         This program is distributed through the SHAREWARE method.  If
  91.         you like it and use it beyond a 30-day trial period you should
  92.         register.  When registering, please print and fill out the
  93.         ARJS-REG.TXT file.  If you fill it in by hand, writing neatly
  94.         will greatly improve the accuracy of my built-in optical
  95.         character reading system.  For registration methods #1 or #2,
  96.         let me know what disk size you require.  The registered version
  97.         of ARJShell does not have the shareware exit screen, and you will
  98.         get the latest version when you register.  Your financial support
  99.         and suggestions are valuable to the future of ARJShell.  There
  100.         are three methods of registering:
  101.  
  102.            1) Send $15 and get latest version (no exit screen) and
  103.               Borland C++ v3.1 source code (it's in C, not C++).
  104.               I'll also include a copy of TCWindow by Don Fordham
  105.               (if you like it, you should register with him).
  106.               Please note: source code is for personal use and
  107.               study.  It is NOT for building and distributing
  108.               derivitive works (ie ARJShell work-a-likes).  If
  109.               you need more details, please write and include
  110.               a self-addressed-stamped-envelope for a reply.
  111.  
  112.            2) Send $8 and get latest version (no exit screen)
  113.  
  114.            3) Send a nice postcard with suggestions or just to say
  115.               thanks.  If you want a reply with method #3, please send
  116.               a self-addressed envelope (try putting the envelope and
  117.               the postcard in a bigger envelope to send me).
  118.  
  119.            The registered version will include your name embedded
  120.            within ARJShell, so PLEASE print your name plainly on
  121.            the registration form.
  122.  
  123.  
  124.            My address is:  Andy Kellett
  125.                            Attn: Shareware
  126.                            Route One Box 430B
  127.                            Summerville, GA  30747-9801
  128.                                         U.S.A.
  129.            (Please PRINT any handwritten correspondence)
  130.  
  131.  
  132.         WHY REGISTER?  Registrations are a vote that you like ARJShell,
  133.         have found it useful, and believe that shareware is a step in
  134.         the right direction (try-before-you-buy should benefit the user
  135.         AND the author by reducing costs at both ends).  It allows the
  136.         author to continue development  (many hours went into ARJShell
  137.         already), listen to user suggestions, and pay for the disks/
  138.         mailers/postage needed to get the big shareware catalogs to
  139.         consider distributing it.  Registering with method #1 or #2 will
  140.         get you the latest version without the shareware screen (and the
  141.         pause) when you exit.  If you like it somewhat, or just can't
  142.         afford to register, try method #3 listed above as a vote of
  143.         confidence to the author.
  144.  
  145.  
  146.                     BUG REPORTS/SUGGESTIONS/CONTACT
  147.         Use it, test it, then let me know what you think.  As an
  148.         alternative to regular mail, you can contact me on the Final
  149.         Burn BBS in Rome GA (706 232 5308) if it's nearby.  I usually
  150.         read my mail twice weekly (see note at end about the Sysop).
  151.         If you do have gripes, please be specific!  I can't make
  152.         improvements based on vague gripes.  Specific gripes are some-
  153.         thing I can work with, having done so for years in the
  154.         mainframe/mini-computer world <slight grin here>.
  155.  
  156.  
  157.                               USAGE NOTES
  158.         CAUTION: I have never lost any data due to ARJ or ARJShell but
  159.         it is always a good practice to make backup copies of anything
  160.         stored on magnetic media.  Lightning does strike somewhere, and
  161.         sunspots *do* ebb and flow.  It helps if you  are already
  162.         familiar with ARJ first, especially the move-to and move-from
  163.         options (the delete stuff hopefully will be obvious to anyone
  164.         who is a compression veteran).
  165.  
  166.         Please be sure ARJ.EXE is in your path somewhere so ARJShell can
  167.         find it.  This program uses approximately 90k of RAM while
  168.         running.  If this causes too many users problems (and they
  169.         register), I'll try spending some serious time reducing this
  170.         amount.  However, in my testing with 560-610k of free RAM it
  171.         hasn't been a problem even with multi-megabyte archive files.
  172.         If you have 512k (total) of RAM or less ARJ may not have enough
  173.         memory to work with, especially if you are using compression
  174.         method JM or JM1.  For more information on memory usage, please
  175.         see the ARJ documentation file (ARJ.DOC).
  176.  
  177.         This version of ARJShell was tested exclusively with ARJ 2.30 --
  178.         the latest version.  If you have an earlier version of ARJ,
  179.         downloading the newest one from a local BBS should be the first
  180.         step towards solving any problems.  There were some reported
  181.         bugs using the Garble function with ARJ v2.21a, so upgrading is
  182.         the best option.  I have also tested using ARJ v2.39a (a BETA
  183.         test version).  It worked fine but I will retest all functions
  184.         when the final version of ARJ v2.40 becomes available.  DOS
  185.         versions 3.1 and above should not cause problems except for
  186.         lack of memory for ARJ itself (again, see ARJ.DOC for more
  187.         details).
  188.  
  189.         ARJShell will live nicely on a floppy disk along with ARJ
  190.         itself.  If you use PKLite on ARJ.EXE (seems to work for me),
  191.         you will have approximately 260k of free space on a 360k floppy!
  192.         For laptop users this will allow easily keeping storage space to
  193.         a minimum (always a premium when travelling).  Desktop users
  194.         can keep infrequently used programs or data files compressed
  195.         until they need them.  I like to store infrequently used
  196.         programs and data in archived format on floppies (1.44MB 3.5")
  197.         to be unarchived only if and when they are needed again.  If
  198.         a shareware program looks even remotely useful, I keep it
  199.         around just in case one of my friends or I need it someday.
  200.         (This has saved my hide more than once when an obscure program
  201.         had to be found).
  202.  
  203.         Although there isn't a specific menu selection to do so, you
  204.         *can* extract only the files you need from an archive.
  205.  
  206.            All files in archive        Selected files in archive
  207.  
  208.           filename -> MYTEST.ARJ        filename ->MYTEST.ARJ
  209.           path     -> D:\               path     ->D:\*.DBF
  210.  
  211.         If this is confusing to many users, I can change the menu
  212.         to have several different extracts (all, some, q/password...).
  213.  
  214.  
  215.         SelF-eXtracting (sfx) EXE files should not be created using the
  216.         M4 compression method.  Accordingly, ARJShell checks for M4 and
  217.         will substitute M3 when creating an sfx EXE file for you.  If
  218.         you DO NOT specify a file specification, ARJShell will default
  219.         to ALL files in the current subdirectory, something you probably
  220.         will not want.  Test all options to be sure what does happen is
  221.         what you expected to happen.  ARJShell lets you create a sfx EXE
  222.         from either an already created archive file or from a file spec
  223.         (non-archived files):
  224.  
  225.                  From an ARJ                From a file spec
  226.  
  227.            filename ->TEST.EXE         filename ->TEST.EXE
  228.            file spec->MYARCHIV.ARJ     file spec->C:\LOTUS\*.WK*
  229.  
  230.         If you are the Sysop of a bulletin board system and need to
  231.         keep track of other BBSs which you receive files from, the
  232.         "Capture comment to file" option can come in handy.  If
  233.         there is a comment for the entire ARJ file, this lets you
  234.         output the comment into a text file you specify.  You can
  235.         browse through these later, or edit the text file and use
  236.         it to comment other archive files.  If you find ARJShell
  237.         handy, whether or not you register, upload it to *your*
  238.         favorite BBS.  You get some upload points and gives other
  239.         users a chance to try a program you find handy.
  240.  
  241.         If you are using a monochrome/amber/composite monitor and
  242.         the default colors look really cruddy, use the /m (or /M)
  243.         command line parameter for monochrome mode:
  244.            ARJSHELL /M
  245.         This should make everything more readable.  This was tested
  246.         on a very burned-out monochrome VGA screen, and an old CGA
  247.         screen which was jumpy and barely readable.  Even if you
  248.         forget to set it for monochrome mode, the default colors
  249.         are fairly readable also -- try both modes and see which
  250.         one you prefer.
  251.  
  252.  
  253.                          OLD ARJSHELL VERSIONS
  254.         The early versions of ARJShell were written in PowerBasic to
  255.         be included with my PBTool shareware package for PowerBasic
  256.         programmers.  The positive response I received after uploading
  257.         it to several local BBS's showed the need for newer versions
  258.         with more options and a revamped user-interface.  Since there
  259.         are lots of windowing packages for C/C++ (I program in C and
  260.         Assembler too), I decided to rewrite it using Borland C++ v3.1
  261.         and the TCWindow shareware package by Don Fordham.  The result
  262.         was a much easier interface for the user, improved response in
  263.         some areas, and removal of some design restraints.  This means
  264.         a better overall program which consumes less memory and disk
  265.         space too.
  266.  
  267.  
  268.                      NEW FEATURES / RELEASE HISTORY
  269.  
  270.         09/1992 version 1.50
  271.  
  272.            *  Completely new user interface
  273.  
  274.            *  Completely rewritten in C
  275.  
  276.            *  Move files to and from an archive
  277.  
  278.            *  Smaller SelF-eXtracting EXE's (also know as SFX)
  279.  
  280.            *  Capture comments to text file
  281.  
  282.            *  Prompt before deleting files from an archive
  283.  
  284.            *  Pause during listing of archive contents
  285.  
  286.            *  View contents of a file within an archive
  287.  
  288.  
  289.         08/1992 version 1.02
  290.  
  291.            * fixed a few minor glitches
  292.  
  293.            * added color per user suggestion [please note that when ARJ
  294.              takes over, it'll use whatever colors DOS is using
  295.              regardless of ARJShell's wishes...]
  296.  
  297.            * added more compression options per user suggestion
  298.  
  299.            * compress files and garble with a password (11 characters)
  300.  
  301.            * extract files from a garbled archive
  302.  
  303.  
  304.         07/1992 version 1.00
  305.  
  306.            * initial release
  307.  
  308.  
  309.                             FUTURE RELEASES:
  310.         I have a few ideas in mind for future versions of ARJShell.
  311.         I expect most changes to come from the users.  We'll see
  312.         how many registrations and requests come in...I'd like for
  313.         the future of ARJShell to be user-driven.  Lemme know.
  314.  
  315.  
  316.                      CREDITS (heroes for them what cares):
  317.         Special thanks to God, my wonderful wife and three special
  318.         kids, my family, and close friends.  Thanks to Mike P. and
  319.         Howard H. (two fine coders and lots-o-fun) for great advice and
  320.         programming info over the years.  To all those who offered
  321.         advice and kindly criticism, ARJShell is much improved beast
  322.         due to your time and trouble.  Borland gets a tip-of-the-cap
  323.         for producing darned good language tools and letting users
  324.         upgrade affordably.  This is the first full-fledged application
  325.         I have written in C.  Although there were lots of smaller-scale
  326.         utilities before, it has been a relatively pleasant learning
  327.         experience.
  328.  
  329.  
  330.                               PLEASE NOTE:
  331.         The Final Burn BBS is run by the Sysop, Critical Mass, and
  332.         operates according to the rules he chooses to employ.  The Sysop
  333.         is in no way endorsing or supporting ARJShell, other than the
  334.         support given to all users of the Final Burn BBS.  My user id on
  335.         the Final Burn is: ANDY KELLETT
  336.  
  337.  
  338.                             TRADEMARKS and more:
  339.         The following names are trademarks of their respective owners:
  340.           PKZIP, PKLite, ARJ, TCWindow, PowerBasic, LZEXE,
  341.           Borland C++ and Turbo C
  342.  
  343.